Chatterbox Announcer (WoW Classic 20주년 서버용)

Game Version: WoW Classic 1.15.8 (빌드 11508), 2.5.5 (빌드 20505), 
Version: 1.1.12 (2026. 4. 15.)

─────────────────────────────
1. 애드온 개요
─────────────────────────────
■ Chatterbox Announcer는 플레이어의 마법정화(흡수) 토템 흡수, 차단, 해제, 디버프 추적, 적대적 주문 시전 경고 같은 전투 상황에서 발생하는 중요한 이벤트들을 실시간으로 알림해주는 애드온입니다. '수다쟁이 주술사'라는 이름으로 만들었던 위크오라를 독립적인 애드온으로 만들었으며, 적대적 주문 시전 경고 기능을 추가하고 여러가지로 보완했습니다.

■ 적대적 시전 알림은 특정 대상의 특정 주문에 대해 나를 대상으로 할 때만 알림을 받는 '나에게' 또는 알림에서 완전히 배제하는 '시전 무시' 목록을 작성해서 알림 공해를 줄일 수 있고, 디폴트챗프레임 방식의 개인채팅으로 설정해서 본인만 볼 수도 있습니다.

■ 채팅창에 출력되는 주문 이름은 클릭 가능한 링크 형태로 제공되어, 마우스를 올리면 툴팁을 확인할 수 있습니다.

─────────────────────────────
2. 주요 기능
─────────────────────────────
■ 전투 로그 알림 (주문 링크 포함)
 - 적이 플레이어 소유의 마법정화(흡수) 토템을 대상으로 주문 시전 시 알림
 - 플레이어가 적의 주문을 '차단'했을 때 알림
 - 플레이어가 적의 버프를 '정화'했거나 아군의 디버프를 '해제'했을 때 알림
 - 플레이어가 타우렌 '전투 발구르기' 시전 시 알림

■ 적대적 시전 알림 (5단계 설정, 주문 링크 포함)
 - [ON(공개채팅+RW)] : 채팅 알림 (센드챗메시지 방식) + 공격대 경보 형식
 - [ON(공개채팅)] : 채팅 알림 (센드챗메시지 방식)
 - [ON(개인채팅+RW)] : 채팅 알림 (디폴트챗프레임 방식) + 공격대 경보 형식
 - [ON(개인채팅)] : 채팅 알림 (디폴트챗프레임 방식)
 - [OFF] : 기능 끄기
 - 적이 나, 파티원, 공격대원 대상 또는 광역 주문 시전 시 차단 가능 여부와 대상 징표를 포함하여 알림
 - ON(공개채팅+RW) 또는 ON(개인채팅+RW) 설정의 경보음은 본 애드온 폴더 안에 SELF_RW.ogg 파일이 있다면 그것이 재생되고, 만약 없다면 RaidWarning.ogg 파일이 재생됩니다. 둘 다 화면 중앙 경보 메시지와 경보음은 플레이어 본인에게만 보이고 들립니다.
 
 [고급 설정]
 1. 즉시 시전 목록 (Instant Cast):
    - 시전 바가 없어 일반적인 경보가 울리지 않는 주문을 직접 등록하여 알림 (예: 영혼의 약탈자/영혼의 누출, 구루바시부족 혈투사/흡혈, 투자딘 강령술사/영혼의 누출)
    - 자기 자신에게 시전(버프/힐)하는 경우와 그 외(광역/타인)의 경우를 구분하여 출력
    - 본인에게 시전 시 본인 디버프 알림과 함께 중복 출력될 수 있음

 2. 나에게만 알림 목록 (Targeted Only):
    - 특정 몬스터의 특정 주문이 파티원/공격대원을 대상으로 할 때는 무시하고, '나'를 대상으로 할 때만 알림을 띄우도록 설정 (예: 오닉시아/화염구)

 3. 시전 무시 목록 (Cast Ignore):
    - 특정 몬스터의 특정 주문 알림을 아예 보고 싶지 않을 때 사용 (예: 구루바시부족 도끼투척병/투척)
    - 유닛 이름 자리에 숫자 0을 입력하면, 시전자가 누구든 해당 주문을 모두 무시합니다. (예: 0/두꺼운 룬매듭 붕대)
    - 너무 자주 시전되거나 중요하지 않은 주문을 등록하여 채팅 창 스팸 방지

 4. 차단 불가 목록 (Unkickable):
    - 와우 클래식 API 한계로 '차단 가능'으로 오인식되는 주문을 직접 등록하여 "차단 불가!"로 정확히 표시 (Spell ID 사용)

■ 본인 디버프 알림 (주문 링크 포함)
 - 플레이어에게 적용된 신규 디버프를 실시간으로 표시
 - 디버프 해제/종료를 감지하여 알림
 - 무시 목록에 등록된 디버프는 알림 제외 (예: 남작의 최후통첩, 약화된 영혼, 즐거운 할로윈 등)

■ 설정 창 열기, 명령어 설명, 현재 설정 알림
 - /수다쟁이 또는 /ca : 설정 창 열기, 명령어 설명, 현재 설정 알림
 
 [명령어 목록]
 - /ca channel <say/party/raid/emote> : 출력 방식 변경
 - /ca toggle combat : 전투 로그 알림 ON/OFF
 - /ca toggle alert  : 적대적 시전 모드 순환 (RW → ON → SRLF_RW → SELF → OFF)
 - /ca toggle player : 본인 디버프 알림 ON/OFF
 - /ca instantcast <유닛이름/주문이름> : 즉시 시전 목록 추가/제거 (단축: /ca ic)
 - /ca me <유닛이름/주문이름> : 나에게만 알림 목록 추가/제거 (예: /ca me 오닉시아/화염구)
 - /ca ci <유닛이름/주문이름> : 시전 무시 목록 추가/제거 (단축: /ca ci). 0/주문이름 입력 시 전체 무시.
 - /ca unkick <SpellID> : 차단 불가 주문 추가/제거
 - /ca ignore <디버프 이름> : 무시할 디버프 추가/제거
 - /ca list <ic/m/ci/u/i> : 목록 확인 (ic:즉시, m:나에게, ci:시전무시, u:차단불가, i:디버프)
 - /ca clear <ic/m/ci/u/i> : 목록 초기화 (ic:즉시, m:나에게, ci:시전무시, u:차단불가, i:디버프)

─────────────────────────────
3. 설치 방법
─────────────────────────────
■ 아래와 같은 폴더 구조로 설치하세요.
Interface
└── AddOns
  └── ChatterboxAnnouncer
    ├── ChatterboxAnnouncer.lua
    ├── ChatterboxAnnouncer_TBC.toc
    ├── ChatterboxAnnouncer_Vanilla.toc
    └── README.txt

■ 게임 내 ‘애드온’ 탭에서 [Chatterbox Announcer]가 활성화되어 있는지 확인합니다.

─────────────────────────────
4. 사용 예시
─────────────────────────────
■ 적대적 주문 시전 (일반):
{엑스}<절규하는 벤시>, <Goyathlay>에게 [벤시의 통곡] 시전 중! 확인!
(주문 이름은 클릭 가능한 링크로 표시됩니다)

■ 즉시 시전 알림 적용 시:
설정: 영혼의 약탈자/영혼의 누출 등록
상황: 몹이 공격대원 A에게 영혼의 누출 사용 (즉시 시전)
출력: {다이아}<영혼의 약탈자>, <뼈도적>에게 [영혼의 누출] 시전 중! 확인!

■ 나에게만 알림 적용 시:
설정: 오닉시아/화염구 등록
상황 1: 오닉시아가 공격대원 B에게 화염구 시전 → 무시
상황 2: 오닉시아가 나(플레이어)에게 화염구 시전 → 경보

■ 시전 무시 (특정 대상) 적용 시:
설정: 구루바시 도끼투척병/투척 등록
상황: 구루바시 도끼투척병이 투척을 시전 → 무시

■ 디버프 적용/해제:
<Goyathlay>에게 [제물] 적용!
[제물] 해제!

■ 마법정화(흡수) 토템 흡수:
마법정화 토템: <스톰윈드정수기>의 [화염구] 흡수

■ 전투 발구르기:
<Goyathlay> 주변에 [전투 발구르기] 쿵!쿵!따!

─────────────────────────────
5. 주의 사항
─────────────────────────────
■ 블리자드의 방침에 의해 출력 방식을 일반(SAY)으로 할 경우에는 야외에서 알림을 볼 수 없습니다. 야외에서 보고 싶은 경우에는 현재 상태에 따라 파티(PARTY), 공격대(RAID), 감정 표현(EMOTE) 중 하나로 설정하세요.

■ 적대적 시전 알림을 'ON(공개채팅+RW)'로 설정하면 '공격대 경보' 형식의 경보 메시지와 경보음이 함께 나옵니다. 다만 플레이어 본인에게만 보이고 들립니다. 그래도 '채팅(일반|파티|공격대|감정표현)'만 원하시면 'ON(공개채팅)'으로, '본인에게 알림'만 원하시면 'ON(개인채팅+중앙)'이나 'ON(개인채팅)'으로 설정하세요.

■ 마법정화(흡수) 토템 알림은 플레이어 소유 토템만 인식합니다.

■ '즉시 시전', '나에게만 알림', '시전 무시' 기능 사용 시 유닛 이름과 주문 이름 사이에 반드시 구분자(/)를 넣어야 합니다. (띄어쓰기 주의)

─────────────────────────────
6. 변경 이력
─────────────────────────────
■ 1.0.0 (2025. 11. 18.)
 - 기본 명령어 /ca 입력 시 명령어 설명, 현재 설정 알림
 - 전투 이벤트 알림 (마법정화 토템, 주문 차단, 정화, 해제, 타우렌 발구르기)
 - 디버프 적용/해제/사라짐 알림 및 무시 목록

■ 1.0.1 (2025. 11. 20.)
 - 이벤트 처리 부분에서 일부 출력 메시지 인자 수정
 - 불타는 성전을 대비해서 마법흡수 토템(현 마법정화 토템) 인식 및 출력 추가

■ 1.1.0 (2025. 11. 26.)
 - 기본 명령어 /ca 입력 시 설정 창 열기
 - 적대적 주문 시전 알림 기능

■ 1.1.1 (2025. 11. 26.)
 - 적대적 주문 시전 알림 메시지 수정
 - 적대적 주문 시전 메시지에 대상 공격대 징표 포함

■ 1.1.2 (2025. 11. 26.)
 - 적대적 주문 시전 알림 설정을 3단계(RW/ON/OFF)로 세분화

■ 1.1.3 (2025. 11. 29.)
 - 차단 불가 주문(Unkickable Spell) 직접 관리 기능 추가 (SpellID 기반)
 - 설정 창 입력 칸에 Placeholder 텍스트 적용

■ 1.1.4 (2025. 12. 3.)
 - '즉시 시전 알림(Instant Cast)' 기능 추가 (시전 바가 없는 주문)
 - '나에게 알림(Targeted Spells)' 기능 추가 (나를 대상으로 하는 주문)
 - '시전 무시(Cast Ignore)' 기능 추가 (주문 시전 알림 무시)
 - 입력 양식: 유닛 이름/주문 이름

■ 1.1.5 (2025. 12. 12.)
 - 설정 창에서 입력하던 도중 Enter나 ESC 키를 클릭해도 포커스를 제거하고 Placeholder 텍스트 재생성

■ 1.1.6 (2025. 12. 18.)
 - 출력 방식이 감정 표현일 때 문맥 수정을 위해 메시지에 접두어 '알립니다. '를 추가

■ 1.1.7 (2026. 1. 5.)
 - 시전 무시 기능 강화: 유닛 이름 대신 0을 입력하여 특정 주문을 모든 대상으로부터 무시하는 기능 추가 (예: 0/두꺼운 룬매듭 붕대)
 - 설정 창의 시전 무시 입력 칸 예시 텍스트 변경

■ 1.1.8 (2026. 1. 15.)
 - 기존 toc 파일명 변경 및 TBC용 toc 추가

■ 1.1.9 (2026. 1. 26.)
 - 기본 명령어 /수다쟁이 추가
 - 모든 주문(적 시전, 차단, 디버프 등) 이름에서 < > 괄호를 제거하고 클릭 가능한 '주문 링크'로 변경 (링크를 가져오지 못할 경우에는 [주문 이름]으로 대체)

■ 1.1.10 (2026. 3. 1.)
 - 에디트 박스 입력값을 설정하는 것 이외의 확인 버튼을 삭제하고, 드롭다운 메뉴 항목을 선택하면 즉시 설정하도록 수정

■ 1.1.11 (2026. 3. 19.)
 - 적대적 시전 알림의 옵션 이름을 수정하고 'ON(개인채팅+RW)'과 'ON(개인채팅)'을 추가
 - ON(공개채팅+RW)과 ON(개인채팅+RW)에 경보음 커스텀을 추가

■ 1.1.12 (2026. 4. 15.)
 - 휴식 상태 zzz 표시가 뜨는 대도시나 여관에서는 적대적 시전 알림을 출력하지 않도록 수정

─────────────────────────────
7. 저작권 및 이용 조건
─────────────────────────────
■ 개인 목적에 한해 자유롭게 사용 가능

■ 개발자 표기

■ 상업적 이용 및 무단 전재/재배포 금지

─────────────────────────────
8. 개발자 정보
─────────────────────────────
■ Author: Goyathlay, 20주년 기념일 펜구스의 흉포 KR 호드

■ Contact: 인게임 우편/디스코드
